home *** CD-ROM | disk | FTP | other *** search
/ HTML - Publishing on the Internet / html_cdrom.iso / editoren / mac / aolpress / Install_AOLpress_1.2.2.hqx / Install AOLpress 1.2.2 / Read Me (Text Only) < prev    next >
Encoding:
Text File  |  1996-08-16  |  16.4 KB  |  275 lines  |  [TEXT/ttxt]

  1.  
  2.                                     AOLpress
  3.  
  4.                       AOLpress 1.2.2 for Macintosh: Readme
  5.     ------------------------------------------------------
  6.  
  7. AOLpress is an integrated browsing and WYSIWYG authoring tool for the World Wide
  8. Web.  AOLpress  was  designed  both  to  make  WWW  authoring more accessible to
  9. beginners and to save valuable time and effort for professional Web publishers.
  10.  
  11.  
  12.     ------------------------------------------------------
  13.  
  14. 1.                              ╩System                             Requirements
  15.         o  Stongly Recommended: 16 megabytes of RAM, requires 8 megabytes of RAM
  16.           minimum*,
  17.         o  Recommended: System 7.x or later
  18.         o   Recommended: 68030 or faster processor. (AOLpress 1.2.2 is now a fat
  19.           binary and will run natively on the Mac 68K and the Mac PPC)
  20.         o  Required: 7 MB╩free on your hard disk
  21.         o Required: Color monitor using at least 256 colors
  22.  
  23.       * If you have low memory, AOLpress may run better using Virtual Memory. Go
  24.     to  the  Apple Menu => Control Panels and select Memory. In this dialog box,
  25.     turn  on Virtual Memory if you haven't already. Next, increase the amount of
  26.     memory  by  1MB.  For  example,  if  your  computer has 8MB built-in-memory,
  27.     increase it to 9MB using the up arrow. Restart your computer.
  28.  
  29.  
  30.     ------------------------------------------------------
  31.  
  32. 2. ╩Networking Requirements
  33.  
  34.       If you plan to use AOLpress as a browser and/or remote authoring tool, you
  35.     will need the following:
  36.         o   Internet  service  provider  (AOL  3.0  for Macintosh will work with
  37.           AOLpress when it is released in Fall 1996)
  38.         o  Modem
  39.         o  Connection software (MacTCP, Open Transport, PPP)
  40.  
  41.  
  42.     ------------------------------------------------------
  43.  
  44. 3.                 ╩Installation                and                Configuration
  45.         1.    Double-click  on  the  "Install  AOLpress  1.2.2" icon. Follow the
  46.           instructions  to  install AOLpress on your system in its own "AOLpress
  47.           Folder". Files created by AOLpress will be placed in this folder.
  48.         2. Double-click on the AOLpress icon.
  49.         3. AOLpress does not insist that you set a proxy server and a name
  50.           server, but it is highly recommended that you set them using
  51.           Tools=>Preferences=>Network.
  52.         4. After you have AOLpress running on your system, you may delete the
  53.           installer file.
  54.         5. Known extension conflict: Adobe Type Reunion (ATR) may cause problems
  55.           for AOLpress. There is an ATR updater available:
  56.           http://www.adobe.com/supportservice/custsupport/FILELIBRARY/ATM/Mac/Ty
  57.           Re12Up.sit.hqx.
  58.         6. Possible conflicts:
  59.               1. Open Transport
  60.               2.    FaxSTF  3.2:  If  you have the Control panel FaxMenu version
  61.                 3.2.2  (FaxSTF  3.2  from  STF Technologies), AOLpress may crash
  62.                 when  it  and  the FaxMenu Control panel are enabled at the same
  63.                 time.  The only workaround right now is to turn off this Control
  64.                 Panel using your Extensions Manager Control Panel.
  65.               3.    Macintosh  Easy  Open Control Panel may cause random crashes
  66.                 while  editing  tables  (possibly  elsewhere). If you experience
  67.                 difficulties, try turning off (or removing if using <System 7.5)
  68.                 this control panel.
  69.               4.    MacOS 7.5.2: ╩We have had several reports of various crashes
  70.                 when running AOLpress. If you are running MacOS 7.5.2 you should
  71.                 probably take the time to install a free upgrade from Apple. ╩In
  72.                 particular,  AOLpress  is  known  to crash when browsing certain
  73.                 sites (e.g., Web Crawler) when running on MacOS 7.5.2. ╩This can
  74.                 be  avoided by entering a DNS entry for the Name Server field in
  75.                 the   Network   Preferences  dialog  (Tools  =>  Preferences  =>
  76.                 Network).
  77.  
  78.       AOLpress does not insist that you set a proxy server and a name server but
  79.     it  is  highly  recommended  that you set them using Tools => Preferences =>
  80.     Network.
  81.  
  82.  
  83.     ------------------------------------------------------
  84.  
  85. 4.                                  ╩Known                                  Bugs
  86.         o    AOLpress  may  crash  when  recursively  webizing  large  directory
  87.           structures. This is because AOLpress is running out of memory. ╩If you
  88.           have this problem you work around it by webizing smaller pieces of the
  89.           directory   (use   the   Options   button   in   the  Webize  dialog).
  90.         o   Changing  the  number  of  colors used for display while AOLpress is
  91.           running     may    cause    a    crash    and    force    a    reboot.
  92.         o   Saving  MiniWeb's: ╩When saving a MiniWeb, AOLpress will recursively
  93.           save  any subwebs which AOLpress has opened in the current session (or
  94.           subwebs  which  contain  files  that  AOLpress has opened) even though
  95.           Recursively Save SubWebs in the Save As Options dialog is NOT checked.
  96.         o  The Stop button is not activated when performing an Import or a Save
  97.           As of a MiniWeb.
  98.         o    The  number  pad  does  not  work  within  AOLpress  dialog  boxes.
  99.         o   Within  a  <center>  tag:  Elements => Get Attribute (or Elements =>
  100.           Image,  Link,  Image  Map,  or  Anchor  with such an attribute already
  101.           selected)  may change the selection to the first attribute item within
  102.           the                            <center>                           tag.
  103.         o   After  using Edit->Make Icon from a MiniWeb view, there is no way to
  104.           revert         back         to         the        default        Icon.
  105.         o   Currently,  there  is  no  direct  way to remove a page as being the
  106.           Stationery  page  for  a  MiniWeb. The workaround is to create a blank
  107.           page  then use Edit->Set Stationery to set it as the stationery page.╩
  108.           
  109.  
  110.  
  111.     ------------------------------------------------------
  112.  
  113. 5. ╩Notes and Hints
  114.  
  115.      General Authoring
  116.         o   AOLpress  is  rather  strict  about enforcing legal HTML. When using
  117.           AOLpress  to edit pages which were created outside of AOLpress, it may
  118.           change  HTML  which  does  not  comply  to  the  HTML 3.2 standard and
  119.           specifications  when  saving  it.  ╩To  view  a  raw HTML file (before
  120.           AOLpress has modified it) choose Tools -> Show HTML and File -> Reload
  121.           from  the  Show  HTML  window.  To save a raw HTML file (without being
  122.           parsed  by AOLpress) choose File -> Save As from the Show HTML window.
  123.         o  Selecting text and formatting: In HTML the formatting information for
  124.           a  paragraph  is  located before the paragraph, unlike word processors
  125.           where  the  formatting  information  is  located  at  the  end  of the
  126.           paragraph. Thus when selecting text to replace formatting, copy/paste,
  127.           or drag/drop it is necessary to include the carriage return before the
  128.           paragraph    if    you   want   the   formatting   to   be   included.
  129.         o   Netscape  vs  HTML  3.2. AOLpress give you the choice of whether the
  130.           display  attempts  to  conform  to  the HTML 3.2 spec or to Netscape's
  131.           interpretation of HTML. (There are many fewer differences than existed
  132.           between  HTML  3.0  and Netscape's interpretation). In some cases this
  133.           affects    the    actual    HTML   AOLpress   generates   and   saves:
  134.                            Tools->Preferences->General
  135.                                 Set to: Netscape
  136.                            Tools->Preferences->General
  137.                                 Set to: HTML 3.2
  138. Multiple Title tags
  139. allowed
  140. not allowed (removed when saved)
  141. Multiple Body tags
  142. allowed
  143. not allowed (removed when saved)
  144. <Script>...<Script>
  145. allows <Script> in the BODY
  146. forces <Script> to reside in HEAD
  147.         o   ">"  within  quoted strings: When viewing pages with the preferences
  148.           (Tools  ->  Preferences  ->  General)  set  to conform to ╩Netscape, a
  149.           greater  than  sign  within  a  quoted string (e.g. ...VALUE=">="... )
  150.           often  terminates  the  tag  even  though  it  should  not. It usually
  151.           displays the rest on the tag in the page. To make the page viewable in
  152.           both  HTML  3.2  and  Netscape  mode (and generally acceptable by more
  153.           browsers)  the  "> "should be converted to ">". This can be done by
  154.           loading the page with prefs set to conform to HTML 3.2 and then saving
  155.           it  back  or  by  manually  making the change in the Show HTML window.
  156.         o   Authoring  <Script>:  When preferences (Tools->Preferences->General)
  157.           are  set  to conform to HTML 3.2, AOLpress places all <Script> tags in
  158.           the  HEAD  of  the HTML document as specified in HTML 3.2. Setting the
  159.           Preferences  to  conform to Netscape will allow you to place <Scripts>
  160.           in  the BODY but it is NOT recommended. Netscape's guide for authoring
  161.           Java  Script  strongly  suggests  defining all script functions in the
  162.           HEAD  of  the  document  and using event handlers embedded within tags
  163.           within      the      BODY      to      call      those      functions.
  164.         o  Deleting Files from a MiniWeb: Using the MiniWeb view AOLpress allows
  165.           the  user  to  Edit=>Cut  or  backspace/delete  an  icon (subsequently
  166.           deleting  the  object)  without  the presence of a confirmation dialog
  167.           box.
  168.         o   Concurrent  Editing: AOLpress when used with a AOLserver version 2.1
  169.           offers the ability to "lock" a page on a server from other editors. If
  170.           "locking" is not being used and concurrent editing of the same page is
  171.           occurring,  changes  may  be overwritten. This usually happens because
  172.           someone  edits a cached version of a page and saves it. Be careful and
  173.           use  reload  often  if  multiple  people  are  editing  the  same page
  174.           concurrently.
  175.         o   Authentication  and  saving  to  a  server. ╩When saving a page to a
  176.           server AOLpress saves all of the page elements as well. ╩If you choose
  177.           to  cancel the authentication of a page you will still be prompted for
  178.           authentication  of  the  page  elements that AOLpress is attempting to
  179.           save.
  180.         o   To  edit  text  or images which are links without following the link
  181.           hold   down   the  Control  (Ctrl)  key  and  click  with  the  mouse.
  182.         o   To  create  a MiniWeb out of a directory, or to regenerate a MiniWeb
  183.           that isn't showing all of the files that it should (after moving files
  184.           outside  of  AOLpress)  use the Webize dialog by pressing Ctrl-Shift-W
  185.           (or     choose     Tools=>Webize     from     the    MiniWeb    view).
  186.         o  Double-click on a link to display the linked page in a new window.
  187.  
  188.      Tables
  189.         o   Selecting  (highlighting) a table in the page view requires that the
  190.           paragraph  before  and after the table be selected. Dragging the mouse
  191.           across  or  double  clicking  on  a  table  will  not highlight it but
  192.           dragging the pointer from the paragraph above to the paragraph beneath
  193.           (or        vice-versa)        will       select       the       table.
  194.         o   Selecting  tables  within  tables and tables at the end of the page:
  195.           ╩When  a  table is the first or last item in a table cell the table is
  196.           not  selectable  with  the  mouse. ╩This is because the selection of a
  197.           table  requires  the  selection  of  a  paragraph before and after the
  198.           table. It is easy to avoid this problem once you are aware of it. When
  199.           creating  tables nested within tables insert paragraphs into the table
  200.           cell (by hitting Return) and place the cursor between these paragraphs
  201.           when  choosing  Create  Table. ╩Extra paragraphs can be easily deleted
  202.           later.
  203.           
  204.             If  you  find yourself in this state, the workaround is to add a <P>
  205.           tag at each end of the table you are trying to select:
  206.               o Highlight some of the table content (as a reference point) and
  207.                 choose Tools=>Show HTML.
  208.               o   The  highlighted  selection  should be highlighted in the Show
  209.                 HTML                                                     window.
  210.                   Insert  <P>  before  the  beginning  table  tag (<TABLE BORDER
  211.                 .....>) to insert a paragraph before the table.
  212.               o   Insert  a  <P>  tag  immediately  after  the closing table tag
  213.                 (</TABLE>) to insert a paragraph after the table
  214.               o   Select  Parse  and  Close  from the file menu in the Show HTML
  215.                 window.
  216.         o  Typing in tables: Resizing tables on the fly as text is inserted is a
  217.           lot  of work and the typing speed in tables can be slower as a result.
  218.           The  more cells there are in the table, the slower the typing will be.
  219.         o   Alter  Table  will  remove  table  attributes  that are not authored
  220.           through       the       AOLpress       menus       (e.g.      Align=).
  221.         o   Using Undo and Redo in Tables sometimes requires two Undos/Redos for
  222.           certain functions (e.g. Merge Cell).
  223.  
  224.      Lists
  225.         o   More  that  one  list element on the same line occurs when there are
  226.           lists  nested  inside  a list without a paragraph tag between the list
  227.           tags.  ╩This  only  happens  when  Edit  Complex  lists is set. ╩It is
  228.           impossible to insert text between two such list elements from the page
  229.           view. The workaround is to manually add <P> tags after the <LI> tag in
  230.           the                  Show                 HTML                 window.
  231.         o   Exiting  from nested lists: AOLpress only allows one level at a time
  232.           to  be  exited.  If  you  wish  to exit multiple nested levels, choose
  233.           Format=>Exit  List  Format multiple times and delete the unwanted list
  234.           elements when finished.
  235.  
  236.      MiniWebs
  237.         o   If  MiniWebs don't reflect the contents of the directory, Webize the
  238.           directory.
  239.            AOLpress can't tell if a MiniWeb filename has been changed outside of
  240.           AOLpress.  If  you  change, add, or delete files or links in a MiniWeb
  241.           outside  of  AOLpress,  or  ever  notice  that the MiniWeb view is not
  242.           reflecting   the   true   status   of   the   directory,  be  sure  to
  243.           webize/regenerate                     the                     MiniWeb.
  244.         o  Changing a filename in a MiniWeb
  245.               o  does not update links in subwebs.
  246.               o  does not update links in image maps
  247.               o     removes    anchor   extensions   from   links   it   changes
  248.         o   When  editing  long  filenames in a MiniWeb using a list view (Name,
  249.           Title,  or MIME type) the file name display allows for ~27 characters.
  250.           ╩After  that the text exceeds the filename box and is displayed behind
  251.           the  title.  ╩The  workaround  is  to use the Web view to rename files
  252.           longer                than                27               characters.
  253.         o   Browsing  for  MiniWeb  icons  by default shows only files with .gif
  254.           extension.  Files  of  type  gif, jpg, and xbm can be used for MiniWeb
  255.           icons.
  256.  
  257.      Display
  258.         o   AOLpress does not display transparent gifs. ╩AOLpress will match the
  259.           background  color,  but  not a background image. When browsing amongst
  260.           pages   referencing  the  same  transparent  gif  but  with  different
  261.           background colors you may notice that the background color for the gif
  262.           is cached as the color of the first visited page. ╩Hitting reload will
  263.           display    the    image    with    the   current   background   color.
  264.  
  265.      Miscellaneous
  266.         o  Opening or editing a page with a large amount of text (>100K) is very
  267.           slow  with  AOLpress,  and AOLpress will crash if given a file that is
  268.           too                                                             large.
  269.         o   Check  Links  will  indicate  "Could  not  find ..." when there is a
  270.           redirect           at           the           specified           URL.
  271.         o   The  hotlist  window does not have a horizontal scroll bar. ╩To read
  272.           long URLs the window may be resized larger.
  273.  
  274.                      Copyright ⌐ 1996 America Online, Inc.
  275.